/*
 * Copyright 2010-2024 JetBrains s.r.o. and Kotlin Programming Language contributors.
 * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
 */

package org.jetbrains.kotlin.gradle.testbase

import com.android.build.api.dsl.CommonExtension
import com.android.build.api.dsl.LibraryExtension
import com.android.build.gradle.AppExtension
import org.gradle.api.Project
import org.gradle.api.flow.*
import org.gradle.api.initialization.Settings
import org.gradle.api.initialization.dsl.ScriptHandler
import org.gradle.api.plugins.JavaPluginExtension
import org.gradle.api.provider.Property
import org.gradle.api.provider.Provider
import org.gradle.api.publish.PublishingExtension
import org.gradle.api.tasks.Input
import org.gradle.internal.exceptions.MultiCauseException
import org.gradle.internal.extensions.core.serviceOf
import org.gradle.kotlin.dsl.create
import org.gradle.plugin.use.PluginDependenciesSpec
import org.gradle.plugin.use.PluginDependencySpec
import org.gradle.plugin.use.PluginId
import org.gradle.plugins.signing.SigningExtension
import org.gradle.testkit.runner.BuildResult
import org.gradle.util.GradleVersion
import org.jetbrains.kotlin.gradle.dsl.KotlinJvmProjectExtension
import org.jetbrains.kotlin.gradle.plugin.cocoapods.CocoapodsExtension
import org.jetbrains.kotlin.gradle.dsl.KotlinMultiplatformExtension
import org.jetbrains.kotlin.gradle.plugin.extraProperties
import org.jetbrains.kotlin.gradle.plugin.mpp.apple.swiftexport.SwiftExportExtension
import java.io.File
import java.io.ObjectInputStream
import java.io.ObjectOutputStream
import java.io.Serializable
import java.lang.reflect.Field
import java.nio.file.Path
import kotlin.io.path.*
import kotlin.jvm.optionals.getOrNull

interface GradleBuildScriptInjection<T> : Serializable {
    fun inject(target: T)
}

/**
 * This injection executes as soon as it is injected with its target
 */
class UndispatchedInjection<Context, Target>(
    val instantiateInjectionContext: (Target) -> Context,
    val executeInjection: Context.() -> Unit,
) : GradleBuildScriptInjection<Target> {
    override fun inject(target: Target) = instantiateInjectionContext(target).executeInjection()
}

/**
 * Serializes returned value on build completion that wraps the returned value in a Provider for CC safety.
 *
 * The injection in general executes at:
 * - Provider serialization time with CC
 * - Build completion without CC
 */
class OnBuildCompletionSerializingInjection<Return>(
    val serializedReturnPath: File,
    val returnValueInjection: GradleProjectBuildScriptInjectionContext.() -> Provider<Return>,
) : GradleBuildScriptInjection<Project> {
    class ExecuteOnBuildFinish : FlowAction<ExecuteOnBuildFinish.Parameters> {
        interface Parameters : FlowParameters {
            @get:Input
            val onBuildFinish: Property<() -> Unit>
        }

        override fun execute(parameters: Parameters) {
            parameters.onBuildFinish.get().invoke()
        }
    }

    override fun inject(target: Project) {
        val returnEvaluationProvider = GradleProjectBuildScriptInjectionContext(target).returnValueInjection()
        val serializeOutput = {
            val returnValue = returnEvaluationProvider.orNull
            serializedReturnPath.outputStream().use {
                ObjectOutputStream(it).writeObject(returnValue)
            }
        }
        if (GradleVersion.current() < GradleVersion.version("8.1")) {
            @Suppress("DEPRECATION")
            target.gradle.buildFinished {
                serializeOutput()
            }
        } else {
            target.serviceOf<FlowScope>().always(
                ExecuteOnBuildFinish::class.java
            ) {
                it.parameters.onBuildFinish.set(serializeOutput)
            }
        }
    }
}

/**
 * Serializes build failure as [CaughtBuildFailure] (or [CaughtBuildFailure.UnexpectedMissingBuildFailure] is there was no failure) upon build completion
 */
class FindMatchingBuildFailureInjection<ExpectedException : Exception>(
    val serializedReturnPath: File,
    val expectedExceptionClass: Class<ExpectedException>,
) : GradleBuildScriptInjection<Project> {
    class CatchBuildFailure : FlowAction<CatchBuildFailure.Parameters> {
        interface Parameters : FlowParameters {
            @get:Input
            val onBuildFinish: Property<(Throwable?) -> Unit>

            @get:Input
            val buildWorkResult: Property<BuildWorkResult>
        }

        override fun execute(parameters: Parameters) {
            parameters.onBuildFinish.get().invoke(
                parameters.buildWorkResult.get().failure.getOrNull()
            )
        }
    }

    override fun inject(target: Project) {
        val serializeOutput: (Throwable?) -> Unit = { topLevelException ->
            val toSerialize = if (topLevelException == null) {
                CaughtBuildFailure.UnexpectedMissingBuildFailure()
            } else {
                val matchingExceptions = findMatchingExceptions(
                    topLevelException,
                    expectedExceptionClass
                )
                if (matchingExceptions.isNotEmpty()) {
                    CaughtBuildFailure.Expected(matchingExceptions)
                } else {
                    CaughtBuildFailure.Unexpected(topLevelException.fullMessage)
                }
            }

            serializedReturnPath.outputStream().use {
                ObjectOutputStream(it).writeObject(toSerialize)
            }
        }

        // Catch the errors caused directly by the build failure
        if (GradleVersion.current() < GradleVersion.version("8.1")) {
            @Suppress("DEPRECATION")
            target.gradle.buildFinished {
                serializeOutput(it.failure)
            }
        } else {
            val result = target.serviceOf<FlowProviders>().buildWorkResult
            target.serviceOf<FlowScope>().always(CatchBuildFailure::class.java) {
                it.parameters.onBuildFinish.set(serializeOutput)
                it.parameters.buildWorkResult.set(result)
            }
        }
    }

    private fun <T : Throwable> findMatchingExceptions(
        topLevelException: Throwable,
        targetClass: Class<T>,
    ): Set<T> {
        val exceptionsStack = mutableListOf(topLevelException)
        val walkedExceptions = mutableSetOf<Throwable>()
        val matchingExceptions = mutableSetOf<T>()
        while (exceptionsStack.isNotEmpty()) {
            val current = exceptionsStack.removeLast()
            if (current in walkedExceptions) continue
            walkedExceptions.add(current)
            if (targetClass.isInstance(current)) {
                @Suppress("UNCHECKED_CAST")
                matchingExceptions.add(current as T)
            }
            exceptionsStack.addAll(
                when (current) {
                    is MultiCauseException -> current.causes.mapNotNull { it }
                    else -> listOfNotNull(current.cause)
                }
            )
        }
        return matchingExceptions
    }
}

private const val buildScriptInjectionsMarker = "// MARKER: GradleBuildScriptInjections Enabled"
private const val buildScriptInjectionsClasspathProperty = "buildScriptInjectionsClasspath"

private fun GradleProject.enableBuildScriptInjectionsIfNecessary(
    buildScript: Path,
    buildScriptKts: Path,
) {
    if (buildScript.exists()) {
        if (buildScript.readText().contains(buildScriptInjectionsMarker)) return
        buildScript.modify {
            it.insertBlockToBuildScriptAfterPluginManagementAndImports(
                """
                $buildScriptInjectionsMarker
                buildscript {
                    println("⚠️ GradleBuildScriptInjections Enabled. Classes from kotlin-gradle-plugin-integration-tests injected to buildscript")               
                    dependencies {
                        classpath(
                            files(
                                ${escapedBuildScriptClasspathUrlsGroovy()}
                            )
                        )
                    }
                }
                
                """.trimIndent()
            )
        }
        return
    }

    if (buildScriptKts.exists()) {
        if (buildScriptKts.readText().contains(buildScriptInjectionsMarker)) return
        buildScriptKts.modify {
            it.insertBlockToBuildScriptAfterPluginManagementAndImports("""
                $buildScriptInjectionsMarker
                buildscript {
                    println("⚠️ GradleBuildScriptInjections Enabled. Classes from kotlin-gradle-plugin-integration-tests injected to buildscript")               
                    val classes = files(
                        ${escapedBuildScriptClasspathUrls()}
                    )
                    dependencies {
                        classpath(classes)
                    }
                }
            
                """.trimIndent()
            )
        }
        return
    }

    error("Neither $buildScriptKts nor $buildScript files found in the Test Project '$projectName'. Please check if it is a valid gradle project")
}

class InjectionLoader {
    @Suppress("unused")
    fun invokeBuildScriptInjection(project: Project, serializedInjectionPath: File) {
        serializedInjectionPath.inputStream().use {
            @Suppress("UNCHECKED_CAST")
            (ObjectInputStream(it).readObject() as GradleBuildScriptInjection<Project>).inject(project)
        }
    }

    @Suppress("unused")
    fun invokeBuildScriptPluginsInjection(project: Project, serializedInjectionPath: File) {
        serializedInjectionPath.inputStream().use {
            @Suppress("UNCHECKED_CAST")
            (ObjectInputStream(it).readObject() as GradleBuildScriptInjection<Pair<ScriptHandler, Project>>).inject(
                Pair(project.buildscript, project)
            )
        }
    }

    @Suppress("unused")
    fun invokeSettingsBuildScriptInjection(settings: Settings, serializedInjectionName: File) {
        serializedInjectionName.inputStream().use {
            @Suppress("UNCHECKED_CAST")
            (ObjectInputStream(it).readObject() as GradleBuildScriptInjection<Settings>).inject(settings)
        }
    }
}

@DslMarker
annotation class BuildGradleKtsInjectionScope

@BuildGradleKtsInjectionScope
class GradleProjectBuildScriptInjectionContext(
    val project: Project,
) {
    val java get() = project.extensions.getByName("java") as JavaPluginExtension
    val kotlinMultiplatform get() = project.extensions.getByName("kotlin") as KotlinMultiplatformExtension
    val kotlinJvm get() = project.extensions.getByName("kotlin") as KotlinJvmProjectExtension
    val cocoapods get() = kotlinMultiplatform.extensions.getByName("cocoapods") as CocoapodsExtension
    val swiftExport get() = kotlinMultiplatform.extensions.getByName("swiftExport") as SwiftExportExtension
    val androidLibrary get() = project.extensions.getByName("android") as LibraryExtension
    val androidApp get() = project.extensions.getByName("android") as AppExtension
    val androidBase get() = project.extensions.getByName("android") as CommonExtension<*, *, *, *, *>
    val publishing get() = project.extensions.getByName("publishing") as PublishingExtension
    val signing get() = project.extensions.getByName("signing") as SigningExtension
    val dependencies get() = project.dependencies
}

@BuildGradleKtsInjectionScope
class GradleSettingsBuildScriptInjectionContext(
    val settings: Settings,
)

@BuildGradleKtsInjectionScope
class GradleBuildScriptBuildscriptInjectionContext(
    val buildscript: ScriptHandler,
    val project: Project,
)

class ReturnFromBuildScriptAfterExecution<T>(
    val returnContainingGradleProject: TestProject,
    val serializedReturnPath: File,
    val injectionLoadProperty: String,
    val defaultEvaluationTask: String = "tasks",
    val defaultBuildAction: BuildAction = BuildActions.build,
) {
    /**
     * Return values to the test by serializing the return after the execution. The benefit of serializing after execution is that we can
     * query anything from relevant tasks since they have executed. However, we have to disable CC, so that the returning closure can reach
     * out for configuration entities.
     */
    fun buildAndReturn(
        vararg buildArguments: String = arrayOf(defaultEvaluationTask),
        executingProject: TestProject = returnContainingGradleProject,
        /**
         * FIXME: With enabled CC and "configuration-cache.problems=fail" if build fails due to CC serialization, Gradle will not report an
         * error in the FlowScope and it will not be caught in [catchBuildFailures]. With "configuration-cache.problems=warn" Gradle
         * always forces CC deserialization before task execution and will therefore produce a catchable build failure, but only if the
         * violating task actually executes
         */
        configurationCache: BuildOptions.ConfigurationCacheValue = BuildOptions.ConfigurationCacheValue.AUTO,
        configurationCacheProblems: BuildOptions.ConfigurationCacheProblems = BuildOptions.ConfigurationCacheProblems.FAIL,
        deriveBuildOptions: TestProject.() -> BuildOptions = { buildOptions },
        buildAction: BuildAction = defaultBuildAction,
    ): T {
        executingProject.buildAction(
            arrayOf(
                *buildArguments,
                "-P${injectionLoadProperty}=true",
            ),
            executingProject.deriveBuildOptions().copy(
                configurationCache = configurationCache,
                configurationCacheProblems = configurationCacheProblems,
            )
        )
        ObjectInputStream(serializedReturnPath.inputStream()).use {
            @Suppress("UNCHECKED_CAST")
            return it.readObject() as T
        }
    }
}

/**
 * Inject build script with a return lambda that serializes the return value at build completion.
 *
 * The [returnFromProject] by default executes without CC and at build completion. If you enable CC it will execute eagerly at CC
 * serialization time.
 *
 * @see org.jetbrains.kotlin.gradle.BuildScriptInjectionIT.consumeProjectDependencyViaSettingsInjection
 */
internal fun <T> TestProject.buildScriptReturn(
    returnFromProject: GradleProjectBuildScriptInjectionContext.() -> T,
): ReturnFromBuildScriptAfterExecution<T> = providerBuildScriptReturn {
    project.provider {
        returnFromProject()
    }
}

/**
 * Inject build script with a return lambda that serializes the return value from a [org.gradle.api.provider.Provider] at build completion.
 *
 * The [returnFromProject] by default executes without CC and at build completion. If you enable CC the closure will execute whenever Gradle
 * serializes the Provider value; in most cases this happens before execution, but for example if you flatMap the task output or derive
 * Provider from [providers.environmentVariable] it might execute at build completion time.
 *
 * @see org.jetbrains.kotlin.gradle.BuildScriptInjectionIT.buildScriptReturnIsCCFriendly
 */
internal fun <T> TestProject.providerBuildScriptReturn(
    returnFromProject: GradleProjectBuildScriptInjectionContext.() -> Provider<T>,
): ReturnFromBuildScriptAfterExecution<T> {
    return buildScriptReturnInjection(
        insertInjection = String::plus,
        injectionProvider = { serializedReturnPath ->
            OnBuildCompletionSerializingInjection(
                serializedReturnPath,
                returnFromProject,
            )
        },
        returnObjectProvider = { serializedReturnPath, injectionIdentifier ->
            ReturnFromBuildScriptAfterExecution(
                this,
                serializedReturnPath,
                injectionIdentifier,
            )
        }
    )
}

sealed class CaughtBuildFailure<ExpectedException : Throwable> : Serializable {
    data class Expected<ExpectedException : Throwable>(val matchedExceptions: Set<ExpectedException>) :
        CaughtBuildFailure<ExpectedException>()

    data class Unexpected<ExpectedException : Throwable>(val stackTraceDump: String) : CaughtBuildFailure<ExpectedException>()
    class UnexpectedMissingBuildFailure<ExpectedException : Throwable> : CaughtBuildFailure<ExpectedException>()

    fun unwrap(): Set<ExpectedException> {
        return when (this) {
            is Expected<ExpectedException> -> matchedExceptions
            is Unexpected<ExpectedException> -> error(stackTraceDump)
            is UnexpectedMissingBuildFailure<ExpectedException> -> error(
                """
                Build completion handler executed, but there were no failures. This likely means either:
                - Build succeeded
                - There was a CC serialization error; these are currently not caught
                """.trimIndent()
            )
        }
    }
}

/**
 * Catch all build failures of type [T] thrown at configuration or execution time. This function returns one of the following:
 * - [CaughtBuildFailure.Expected]: The caught exception of type [T] thrown some time during the build
 * - [CaughtBuildFailure.Unexpected]: The backtrace of the top level exception caught by the build when [T] wasn't found in the exception cause graph
 * - [CaughtBuildFailure.UnexpectedMissingBuildFailure]: Build was expected to fail, but no failure was reported by Gradle
 *
 * FIXME: Currently CC serialization failures are not caught - KT-74367
 */
internal inline fun <reified T : Exception> TestProject.catchBuildFailures(): ReturnFromBuildScriptAfterExecution<CaughtBuildFailure<T>> {
    return buildScriptReturnInjection(
        insertInjection = String::insertBlockToBuildScriptAfterPluginsAndImports,
        injectionProvider = { serializedReturnPath ->
            FindMatchingBuildFailureInjection(
                serializedReturnPath,
                T::class.java,
            )
        },
        returnObjectProvider = { serializedReturnPath, injectionIdentifier ->
            ReturnFromBuildScriptAfterExecution(
                this,
                serializedReturnPath,
                injectionIdentifier,
                defaultBuildAction = BuildActions.buildAndFail,
            )
        }
    )
}

private fun <T> GradleProject.buildScriptReturnInjection(
    insertInjection: String.(insertion: String) -> String,
    injectionProvider: (serializedReturnPath: File) -> GradleBuildScriptInjection<Project>,
    returnObjectProvider: (serializedReturnPath: File, injectionIdentifier: String) -> ReturnFromBuildScriptAfterExecution<T>,
): ReturnFromBuildScriptAfterExecution<T> {
    markAsUsingInjections()
    enableBuildScriptInjectionsIfNecessary(
        buildGradle,
        buildGradleKts,
    )
    val injectionIdentifier = generateIdentifier()
    val serializedReturnPath = projectPath.resolve("serializedReturnConfiguration_${injectionIdentifier}").toFile()
    val injection = injectionProvider(serializedReturnPath)

    val serializedInjectionPath = projectPath.resolve("serializedInjection_${injectionIdentifier}").toFile()
    serializedInjectionPath.outputStream().use {
        ObjectOutputStream(it).writeObject(injection)
    }

    fun whenPropertySpecified(
        property: String,
        execute: String,
    ): String = """
    
        if (providers.gradleProperty("$property").getOrNull() != null) {
            $execute
        }
        
    """.trimIndent()

    when {
        buildGradleKts.exists() -> buildGradleKts.modify {
            it.insertInjection(
                whenPropertySpecified(
                    injectionIdentifier,
                    injectionLoadProject(serializedInjectionPath)
                )
            )
        }
        buildGradle.exists() -> buildGradle.modify {
            it.insertInjection(
                whenPropertySpecified(
                    injectionIdentifier,
                    injectionLoadProjectGroovy(serializedInjectionPath)
                )
            )
        }
        else -> error("Can't find the build script to append the return injection")
    }

    return returnObjectProvider(serializedReturnPath, injectionIdentifier)
}

/**
 * Inject build script with a lambda that will be executed by the build script at configuration time.
 *
 * The [code] closure is going to be serialized to a file using Java serialization. This allows the instance of the lambda to capture
 * serializable parameters from the test. When the build script executes, it deserializes the lambda instance and executes it.
 *
 * @see org.jetbrains.kotlin.gradle.BuildScriptInjectionIT.publishAndConsumeProject
 */

fun GradleProject.buildScriptInjection(
    code: GradleProjectBuildScriptInjectionContext.() -> Unit,
) {
    markAsUsingInjections()
    enableBuildScriptInjectionsIfNecessary(
        buildGradle,
        buildGradleKts,
    )
    loadInjectionDuringEvaluation<GradleProjectBuildScriptInjectionContext, Project>(
        buildGradle,
        buildGradleKts,
        ::injectionLoadProject,
        ::injectionLoadProjectGroovy,
        { GradleProjectBuildScriptInjectionContext(it) },
        code,
    )
}

/**
 * Add KGP to the build script classpath by transferring repositories from settings pluginManagement into project build script's buildscript
 * repositories and inject the buildscript block with KGP (without applying any plugins)
 *
 * @see org.jetbrains.kotlin.gradle.BuildScriptInjectionIT
 */
fun TestProject.addKgpToBuildScriptCompilationClasspath() {
    val kotlinVersion = buildOptions.kotlinVersion
    transferPluginRepositoriesIntoBuildScript()
    buildScriptBuildscriptBlockInjection {
        buildscript.configurations.getByName("classpath").dependencies.add(
            buildscript.dependencies.create("org.jetbrains.kotlin:kotlin-gradle-plugin:${kotlinVersion}")
        )
    }
}

fun TestProject.addAgpToBuildScriptCompilationClasspath(androidVersion: String) {
    transferPluginRepositoriesIntoBuildScript()
    buildScriptBuildscriptBlockInjection {
        buildscript.configurations.getByName("classpath").dependencies.add(
            buildscript.dependencies.create("com.android.tools.build:gradle:${androidVersion}")
        )
    }
}

fun TestProject.addEcosystemPluginToBuildScriptCompilationClasspath() {
    val kotlinVersion = buildOptions.kotlinVersion
    settingsBuildScriptBuildscriptBlockInjection {
        settings.buildscript.configurations.getByName("classpath").dependencies.add(
            settings.buildscript.dependencies.create("org.jetbrains.kotlin:kotlin-gradle-ecosystem-plugin:$kotlinVersion")
        )
    }
}

/**
 * This helper method works similar to "plugins {}" block in the build script; it resolves the POM pointer to the plugin jar and applies the plugin
 */
fun TestProject.plugins(build: PluginDependenciesSpec.() -> Unit) {
    val spec = TestPluginDependenciesSpec()
    spec.build()
    transferPluginRepositoriesIntoBuildScript()
    transferPluginDependencyConstraintsIntoBuildscriptClasspathDependencyConstraints()
    buildScriptBuildscriptBlockInjection {
        spec.plugins
            .filter {
                // filter out Gradle's embedded plugins
                !it.id.startsWith("org.gradle")
            }
            .supportGradleBuiltInPlugins()
            .forEach {
                val pluginPointer = buildscript.dependencies.create(
                    group = it.id,
                    name = "${it.id}.gradle.plugin",
                    version = it.version,
                )
                buildscript.configurations.getByName("classpath").dependencies.add(pluginPointer)
            }
    }
    buildScriptInjection {
        spec.plugins
            .filter { it.shouldBeApplied }
            .supportGradleBuiltInPlugins()
            .forEach {
                project.plugins.apply(it.id)
            }
    }
}

private fun List<TestPluginDependencySpec>.supportGradleBuiltInPlugins() = map { spec ->
    if (spec.id == "kotlin-dsl") {
        TestPluginDependencySpec("org.gradle.kotlin.kotlin-dsl")
    } else spec
}

private class TestPluginDependencySpec(
    val id: String,
): PluginDependencySpec, Serializable {
    var version: String? = null
    var shouldBeApplied = true

    override fun version(version: String?): PluginDependencySpec {
        this.version = version
        return this
    }

    override fun apply(apply: Boolean): PluginDependencySpec {
        shouldBeApplied = apply
        return this
    }
}

private class TestPluginDependenciesSpec : PluginDependenciesSpec, Serializable {
    val plugins = mutableListOf<TestPluginDependencySpec>()
    override fun id(id: String): PluginDependencySpec = TestPluginDependencySpec(id).also { plugins.add(it) }
}

private fun Class<*>.getPrivateField(fieldName: String): Field {
    var clazz: Class<*>? = this
    while (clazz != null) {
        try {
            val field = clazz.getDeclaredField(fieldName)
            return field
        } catch (e: NoSuchFieldException) {
            clazz = clazz.superclass
        }
    }
    throw NoSuchFieldException("Field '$fieldName' not found in class hierarchy")
}

/**
 * Inject the [buildscript] block of the project build script. The primary use case for this injection is the configuration of the build
 * script classpath before plugin application
 */
fun GradleProject.buildScriptBuildscriptBlockInjection(
    code: GradleBuildScriptBuildscriptInjectionContext.() -> Unit
) {
    markAsUsingInjections()
    enableBuildScriptInjectionsIfNecessary(
        buildGradle,
        buildGradleKts,
    )
    val buildscriptBlockInjection = serializeInjection<GradleBuildScriptBuildscriptInjectionContext, Pair<ScriptHandler, Project>>(
        instantiateInjectionContext = { GradleBuildScriptBuildscriptInjectionContext(it.first, it.second) },
        code = code,
    )
    when {
        buildGradle.exists() -> buildGradle.prependToOrCreateBuildscriptBlock(
            scriptIsolatedInjectionLoadGroovy(
                "invokeBuildScriptPluginsInjection",
                "project",
                Project::class.java.name,
                buildscriptBlockInjection,
            )
        )
        buildGradleKts.exists() -> buildGradleKts.prependToOrCreateBuildscriptBlock(
            scriptIsolatedInjectionLoad(
                "invokeBuildScriptPluginsInjection",
                "project",
                Project::class.java.name,
                buildscriptBlockInjection,
            )
        )
        else -> error("Can't find the build script to append the injection")
    }
}

fun GradleProject.settingsBuildScriptBuildscriptBlockInjection(
    code: GradleSettingsBuildScriptInjectionContext.() -> Unit,
) {
    markAsUsingInjections()
    enableBuildScriptInjectionsIfNecessary(
        settingsGradle,
        settingsGradleKts,
    )
    val buildscriptBlockInjection = serializeInjection<GradleSettingsBuildScriptInjectionContext, Settings>(
        instantiateInjectionContext = { GradleSettingsBuildScriptInjectionContext(it) },
        code = code,
    )
    when {
        settingsGradle.exists() -> settingsGradle.prependToOrCreateBuildscriptBlock(
            scriptIsolatedInjectionLoadGroovy(
                "invokeSettingsBuildScriptInjection",
                "settings",
                Settings::class.java.name,
                buildscriptBlockInjection,
            )
        )
        settingsGradleKts.exists() -> settingsGradleKts.prependToOrCreateBuildscriptBlock(
            scriptIsolatedInjectionLoad(
                "invokeSettingsBuildScriptInjection",
                "settings",
                Settings::class.java.name,
                buildscriptBlockInjection,
            )
        )
        else -> error("Can't find the build script to append the injection")
    }
}

/**
 * Allow [buildscript] configurations (classpath) to see the same set of repositories that are normally visible to the [plugins] block in
 * build.gradle.kts
 */
private const val transferPluginRepositoriesIntoProjectRepositories = "transferPluginRepositoriesIntoProjectRepositories"
fun GradleProject.transferPluginRepositoriesIntoBuildScript() {
    markAsUsingInjections()
    settingsBuildScriptInjection {
        if (!settings.extraProperties.has(transferPluginRepositoriesIntoProjectRepositories)) {
            settings.extraProperties.set(transferPluginRepositoriesIntoProjectRepositories, true)
            settings.pluginManagement.repositories.all { rep ->
                settings.gradle.beforeProject { project ->
                    project.buildscript.repositories.add(rep)
                }
            }
        }
    }
}

/**
 * Allow [buildscript] classpath configuration to resolve the versions of plugins declared in the settings.pluginManagement.plugins
 * dependency constraints
 */
private const val transferPluginDependencyConstraintsIntoProjectRepositories = "transferPluginDependencyConstraintsIntoProjectBuildscriptClasspathConfiguration"
fun GradleProject.transferPluginDependencyConstraintsIntoBuildscriptClasspathDependencyConstraints() {
    markAsUsingInjections()
    settingsBuildScriptInjection {
        val pluginVersionsField = settings.pluginManagement.resolutionStrategy.javaClass.getPrivateField("pluginVersions")
        pluginVersionsField.isAccessible = true
        @Suppress("UNCHECKED_CAST")
        val pluginVersions = pluginVersionsField.get(settings.pluginManagement.resolutionStrategy) as Map<PluginId, String>
        if (!settings.extraProperties.has(transferPluginDependencyConstraintsIntoProjectRepositories)) {
            settings.extraProperties.set(transferPluginDependencyConstraintsIntoProjectRepositories, true)
            settings.gradle.beforeProject { project ->
                pluginVersions.forEach {
                    val pluginId = it.key.id
                    val pluginVersion = it.value
                    project.buildscript.configurations.getByName("classpath").dependencyConstraints.add(
                        project.buildscript.dependencies.constraints.create(
                            "${pluginId}:${pluginId}.gradle.plugin:${pluginVersion}",
                        )
                    )
                }
            }
        }
    }
}

/**
 * Transfer dependencyResolutionManagement into project for compatibility with Gradle <8.1 because we emit repositories in the
 * build script there
 */
private const val transferDependencyResolutionRepositoriesIntoProjectRepositories =
    "transferDependencyResolutionRepositoriesIntoProjectRepositories"

fun GradleProject.transferDependencyResolutionRepositoriesIntoProjectRepositories() {
    settingsBuildScriptInjection {
        if (!settings.extraProperties.has(transferDependencyResolutionRepositoriesIntoProjectRepositories)) {
            settings.extraProperties.set(transferDependencyResolutionRepositoriesIntoProjectRepositories, true)
            settings.gradle.beforeProject { project ->
                settings.dependencyResolutionManagement.repositories.all { rep ->
                    project.repositories.add(rep)
                }
            }
        }
    }
}

private val buildscriptBlockStartPattern = Regex("""buildscript\s*\{.*""")
private fun Path.prependToOrCreateBuildscriptBlock(code: String) = modify {
    it.prependToOrCreateBuildscriptBlock(code)
}

internal fun String.prependToOrCreateBuildscriptBlock(code: String): String {
    val content = this
    val match = buildscriptBlockStartPattern.find(content)
    return if (match != null) {
        buildString {
            appendLine(content.substring(0, match.range.last + 1))
            appendLine(code)
            append(content.substring(match.range.last + 1, content.length))
        }
    } else {
        content.insertBlockToBuildScriptAfterPluginManagementAndImports(
            buildString {
                appendLine("buildscript {")
                appendLine(code)
                appendLine("}")
            }
        )
    }
}

/**
 * Inject settings build script with a lambda that will be executed by at configuration time. This injection can be used for arbitrary
 * settings logic: multi-project setups, dependency management, etc.
 *
 * @see org.jetbrains.kotlin.gradle.BuildScriptInjectionIT.consumeProjectDependencyViaSettingsInjection
 */
fun GradleProject.settingsBuildScriptInjection(
    code: GradleSettingsBuildScriptInjectionContext.() -> Unit,
) {
    loadInjectionDuringEvaluation<GradleSettingsBuildScriptInjectionContext, Settings>(
        settingsGradle,
        settingsGradleKts,
        ::injectionLoadSettings,
        ::injectionLoadSettingsGroovy,
        { GradleSettingsBuildScriptInjectionContext(it) },
        code,
    )
}

private fun <Context, Target> GradleProject.loadInjectionDuringEvaluation(
    buildScript: Path,
    buildScriptKts: Path,
    injectionLoad: (File) -> String,
    injectionLoadGroovy: (File) -> String,
    instantiateInjectionContext: (Target) -> Context,
    code: Context.() -> Unit,
) {
    val serializedInjectionPath = serializeInjection(instantiateInjectionContext, code)
    when {
        buildScriptKts.exists() -> buildScriptKts.appendText(injectionLoad(serializedInjectionPath))
        buildScript.exists() -> buildScript.appendText(injectionLoadGroovy(serializedInjectionPath))
        else -> error("Can't find the build script to append the injection")
    }
}

private fun <Context, Target> GradleProject.serializeInjection(
    instantiateInjectionContext: (Target) -> Context,
    code: Context.() -> Unit,
): File {
    val injection = UndispatchedInjection(instantiateInjectionContext, code)
    val serializedInjectionPath = projectPath
        .resolve("serializedConfiguration_${generateIdentifier()}")
        .toFile()
    serializedInjectionPath.outputStream().use {
        ObjectOutputStream(it).writeObject(injection)
    }
    return serializedInjectionPath
}

/**
 * Settings injections must use [scriptIsolatedInjectionLoad] instead of the [enableBuildScriptInjectionsIfNecessary] mechanism. This is
 * because [GradleProjectBuildScriptInjectionContext] must be loaded by the build script's classloader to
 *  - be able to see KGP classes loaded by the build script classloader
 *  - be visible to the execution-time classloader in runs with CC
 *
 * Settings injections only run at configuration time and must therefore prevent Gradle from loading any classes into the settings
 * classloader. Gradle disposes of the settings classloader before execution and complains if the project build script referenced anything
 * captured for execution from this classloader
 */
private fun scriptIsolatedInjectionLoad(
    targetMethodName: String,
    targetPropertyName: String,
    targetPropertyClassName: String,
    serializedInjectionPath: File,
): String {
    val lambdaName = "invokeInjection${serializedInjectionPath.name.replace("-", "_")}"

    return """
        
        val $lambdaName = {
            val testClasses = arrayOf(
                ${escapedBuildScriptClasspathUrls()}
            )
            val injectionLoaderClass = java.net.URLClassLoader(
                testClasses, 
                this.javaClass.classLoader
            ).loadClass("${InjectionLoader::class.java.name}")
            injectionLoaderClass.getMethod(
                "$targetMethodName",
                Class.forName("$targetPropertyClassName"),
                Class.forName("java.io.File")
            ).invoke(
                injectionLoaderClass.getConstructor().newInstance(), 
                ${targetPropertyName},
                File("${serializedInjectionPath.path.normalizePath()}")
            )
        }
        ${lambdaName}()
    """.trimIndent()
}

private fun scriptIsolatedInjectionLoadGroovy(
    targetMethodName: String,
    targetPropertyName: String,
    targetPropertyClassName: String,
    serializedInjectionPath: File,
): String {
    val lambdaName = "invokeInjection${serializedInjectionPath.name.replace("-", "_")}"

    return """
        
        def ${lambdaName} = {
            URL[] testClasses = [
                ${escapedBuildScriptClasspathUrlsGroovy()}
            ]
            def injectionLoaderClass = new URLClassLoader(
                testClasses, 
                this.getClass().classLoader
            ).loadClass('${InjectionLoader::class.java.name}')
            injectionLoaderClass.getMethod(
                '${targetMethodName}',
                Class.forName('${targetPropertyClassName}'),
                Class.forName('java.io.File')
            ).invoke(
                injectionLoaderClass.getConstructor().newInstance(), 
                ${targetPropertyName},
                new java.io.File('${serializedInjectionPath.path.normalizePath()}')
            )
        }
        ${lambdaName}()
    """.trimIndent()
}

private fun injectionLoadSettings(
    serializedInjectionPath: File,
): String = scriptIsolatedInjectionLoad(
    "invokeSettingsBuildScriptInjection",
    "settings",
    Settings::class.java.name,
    serializedInjectionPath,
)

private fun injectionLoadSettingsGroovy(
    serializedInjectionPath: File,
): String = scriptIsolatedInjectionLoadGroovy(
    "invokeSettingsBuildScriptInjection",
    "settings",
    Settings::class.java.name,
    serializedInjectionPath,
)

private fun injectionLoadProject(
    serializedInjectionPath: File,
): String = """
    
    org.jetbrains.kotlin.gradle.testbase.InjectionLoader().invokeBuildScriptInjection(project, File("${serializedInjectionPath.path.normalizePath()}"))
""".trimIndent()

private fun injectionLoadProjectGroovy(
    serializedInjectionPath: File,
): String = """
    
    new org.jetbrains.kotlin.gradle.testbase.InjectionLoader().invokeBuildScriptInjection(project, new java.io.File('${serializedInjectionPath.path.normalizePath()}'))
""".trimIndent()

private fun escapedBuildScriptClasspath(): List<String> {
    val injectionClasses = System.getProperty(buildScriptInjectionsClasspathProperty)
        ?: error("Missing required system property '${buildScriptInjectionsClasspathProperty}'")
    return injectionClasses.split(":").map { path ->
        path.replace("\\", "\\\\").replace("$", "\\$")
    }
}

private fun escapedBuildScriptClasspathUrlsGroovy() = escapedBuildScriptClasspath().joinToString("\n") { "new File('${it}').toURI().toURL()," }
private fun escapedBuildScriptClasspathUrls() = escapedBuildScriptClasspath().joinToString("\n") { "File(\"$it\").toURI().toURL()," }
